home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / msgtos20.zip / MSGBBS.DOC < prev    next >
Text File  |  1992-02-11  |  72KB  |  2,311 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                           MSGTOSS Version 2.0
  16.  
  17.           High-Performance FidoNet Mail Processor for RBBS-PC
  18.  
  19.         Copyright(c) 1989-92, Mike Zakharoff & Warren Muldrow
  20.  
  21.                Mike  : FidoNet 1:138/154 Rbbsnet 8:918/10
  22.                Warren: FidoNet 1:3617/1  Rbbsnet 8:928/1
  23.  
  24.  
  25.                           ALL RIGHTS RESERVED
  26.  
  27.  
  28.                     R E F E R E N C E    M A N U A L
  29.  
  30.                                   for
  31.  
  32.                               MSGTOSS.BBS
  33.  
  34.  
  35.                          Written by Mike Zakharoff
  36.  
  37.  
  38. The MSGTOSS.BBS file is similar to the standard "AREAS.BBS" file that other
  39. mail processors (CONFMAIL,  QMAIL, RBBSMAIL, AREAFIX) use.   Beginning with
  40. version  2.0 of MSGTOSS,  the MSGTOSS.BBS file needs  to contain conference
  41. specific  keywords  that affect what MSGTOSS  does when a message is  being
  42. tossed into an RBBS and/or Fido-style area.
  43.  
  44. For description purposes, these are referred to as "key words", in this and
  45. other MSGTOSS documents.
  46.  
  47.  
  48.                                  DISCLAIMER 
  49.                                  ---------- 
  50. The  authors make no claims or warranties with respect  to the contents  or
  51. accuracy  of this publication,  or the product it describes,  including any
  52. warranties  of fitness or merchantability for a  particular purpose.    Any
  53. stated   or  expressed warranties  are  in  lieu   of  all  obligations  or
  54. liability for any damages,  whether special,   indirect,  or consequential,
  55. arising   out  of or  in  connection  with the  use of this publication  or
  56. the product it describes.   Furthermore, the  right is reserved to make any
  57. changes  to this  publication  without   obligation  to  notify  any person
  58. of such changes. 
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                          MSGTOSS.BBS Reference Manual
  69.  
  70.  
  71.                                L I C E N S E
  72.                                -------------
  73.  
  74. MSGTOSS  is   not a  Public Domain  program and is not  free.   MSGTOSS  is
  75. copyright(c)  1989,1990,1991,1992  by  Mike Zakharoff and  Warren  Muldrow.
  76. Non-registered users of  this  program are  granted a  two week license  to
  77. evaluate   the program suitability for their requirements.   Any usage   of
  78. Msgtoss  beyond evaluation time period requires registration.   Use of non-
  79. registered  copies of Msgtoss beyond the original evaluation  period is not
  80. wished. You are free to distribute the PUBLICLY AVAILABLE shareware version
  81. of MSGTOSS.
  82.  
  83. MSGTOSS is SHAREWARE.  MSGTOSS was not an easy project,  as  it took 1000's
  84. of hours to develop and test.  The author has written other  RBBS utilities
  85. such as MSGRENUM, MAILWAIT, MSGECHO, FIXMSG, all of which  were released as
  86. freeware;   none  of  which  compares  to  the complexity  of MSGTOSS.  Fu-
  87. ture releases of MSGTOSS will depend upon  how much support  the author re-
  88. ceives.  Therefore the author is asking for $25.00 for its use to:
  89.  
  90.                                MIKE ZAKHAROFF
  91.                              18004 22ND ST CT E
  92.                               SUMNER, WA 98390
  93.  
  94. Keep  in mind that the authors could have easily crippled MSGTOSS with  all
  95. sorts  of schemes,  including disabling the multi-tasking/network  support,
  96. requiring a password,  annoying "not-registered" lines appended to the tear
  97. line,  beg screens, long delays,  and other things to pester you to support
  98. the authors.  If I were to figure out the amount of hours it took to devel-
  99. op and test this program, it would easily run into 10,000 hours of personal
  100. time  that really can't be assigned any value.   This was a service to  the
  101. RBBS-PC community, and its development will set the stage for RBBS-PC's fu-
  102. ture in the Fidonet comminity.  Cards and letters always welcome!
  103.  
  104. Registered  users will receive a personal registration code (See REGCODE in
  105. MSGCFG.DOC),  and  as much personal support as   possible.   Non-supporters
  106. will basically be doomed to slither in their own guilt for all eternity. 
  107.  
  108.  
  109.                                  WARRANTIES
  110.                                  ----------
  111.  
  112. MSGTOSS  is guaranteed only to occupy space on your hard drive.   Therefore
  113. the  use  of  MSGTOSS  is  solely at your own risk!  MSGTOSS had been  beta
  114. tested  extensively  to  eliminate bugs, however due to the limitless  pos-
  115. sibilities   of   system  configurations,  no warranty is  possible.  Also,
  116. there are no guarantees that the author will upgrade MSGTOSS.
  117.  
  118.  
  119.                                  TRADEMARKS
  120.                                  ----------
  121.  
  122. The following products are mentioned in this document:
  123.  
  124. Areafix,Confmail,Qmail,RBBS-PC & RbbsMail
  125.  
  126.  
  127.  
  128.                                    Page - 2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                          MSGTOSS.BBS Reference Manual
  135.  
  136.  
  137.                            TABLE OF CONTENTS
  138.                            -----------------
  139.  
  140.                                                                Page
  141.  
  142.       MSGTOSS.BBS keywords ...................................  4
  143.          Keyword List ........................................  4
  144.  
  145.       MSGTOSS.BBS Sections ...................................  6
  146.          Default Origin Line .................................  6
  147.          RBBS (M.DEF) Areas ..................................  7
  148.          FIDO (#.MSG) Areas ..................................  7
  149.          Area Name ...........................................  8
  150.          Nodes Listing .......................................  8
  151.  
  152.       Sample MSGTOSS.BBS File ................................ 10
  153.  
  154.       Special Areas .......................................... 12
  155.          AREA:NETMAIL ........................................ 12
  156.          AREA:UNKNOWN ........................................ 13
  157.          AREA:MSGCAPTURE ..................................... 13
  158.          AREA:ROUTETHRU ...................................... 13
  159.  
  160.       Passthru Areas ......................................... 14
  161.  
  162.       NBBS:file .. Chain to the next BBS file ................ 15
  163.       RECS:xxxx .. No. of records in RBBS message base(s) .... 16
  164.       RNIF:xxxx .. Re-number msg only if last exceed xxxx .... 18
  165.       RNST:xxxx .. Re-number msg bases starting with xxxx .... 19
  166.       ESEC:xxxx .. Security level of tossed messages set to .. 20
  167.       NODE:xxxx .. The "home" NODE address for the echo ...... 21
  168.       MAXL:xxxx .. Max lines before MSGTOSS auto-breaks msg .. 23
  169.       SLAK:xxxx .. Min free messages if overflow condition ... 24
  170.       MRGN:xx .... Format right margin of RBBS messages to ... 25
  171.       PRIV:x ..... Whether to honor PRIVATE ECHOMAIL msgs .... 26
  172.       FMAS:x ..... Force Msgs to M.DEFs as Already Scanned ... 27
  173.       SECL:x ..... Strip Echo Control Lines (Only FMAS:1) .... 28
  174.       USRH:x ..... Hash USERS to keep msgs while purging ..... 29
  175.       CAPT:x ..... Capture messages with special text ........ 30
  176.       CDUP:x ..... Enable Duplicate Checking for AREA ........ 31
  177.       MWST:x ..... Set Mailwaiting Bits for new RBBS msgs .... 32
  178.       HIST:x ..... Maintain a history file of purged messages. 33
  179.       GATE:x ..... Zone/Domain gating option ................. 34
  180.       ORGN:text .. Origin: line to be used for scanning ...... 35
  181.  
  182.       INDEX (See MSGIDX.DOC).................................. <-
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                    Page - 3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                          MSGTOSS.BBS Reference Manual
  201.  
  202.  
  203. MSGTOSS.BBS keywords
  204. --------------------
  205.  
  206. The  MSGTOSS.BBS file is similar to the standard "AREAS.BBS"  file that
  207. other  mail processors (CONFMAIL,  QMAIL,  RBBSMAIL,  AREAFIX) use.  In
  208. fact,  it should be fully compatible with all of them.  This allows the
  209. sysop  to  maintain just one AREAS.BBS file which all other  mail  pro-
  210. cessors can share.
  211.  
  212. Historically,  the  AREAS.BBS  (MSGTOSS.BBS)  file contained  the  Fido
  213. SUB-DIRECTORY where the conference resided,  the official FIDONET  NAME
  214. of the conference,  and the NET/NODES of other systems who are  on dis-
  215. tribution  of the conference (all on one line).  However,   MSGTOSS re-
  216. quires  special entries in the MSGTOSS.BBS file which deviate from this
  217. standard format, but should not affect other mail  processors.
  218.  
  219. Beginning  with version 2.0 of MSGTOSS,  the MSGTOSS.BBS file needs  to
  220. contain  'conference specific'  keywords that affect what MSGTOSS  does
  221. when  a message is being tossed into (or scanned from) a specific  con-
  222. ference.   Here  is a summary of the MSGTOSS.BBS "key words",  as  they
  223. will be referred to in this and other MSGTOSS documents.
  224.  
  225.  
  226.      KEYWORD LIST
  227.      ------------
  228.      Logically 'Chain' to the next BBS file ---> NBBS:[path]Filename.ext
  229.      No. of records in RBBS message base(s) ---> RECS:xxxx
  230.      Re-number msg only if last exceed xxxx ---> RNIF:xxxx
  231.      Re-number msg bases starting with xxxx ---> RNST:xxxx
  232.      Security level tossed msgs set to xxxx ---> ESEC:xxxx
  233.      The "home" NODE address for the echo -----> NODE:xxxx
  234.      Max Lines before MsgToss auto-breaks msg -> MAXL:xxxx
  235.      Minimum number of 'free' message slots ---> SLAK:xxxx
  236.      Format right margin of RBBS messages to --> MRGN:xx   (30 thru 79)
  237.      Whether to honor PRIVATE echomail --------> PRIV:x    (1=yes 0=no)
  238.      Force Msgs to M.DEFs as Already Scanned --> FMAS:x    (1=yes 0=no)
  239.      Strip Echo Control Lines (Only FMAS:1) ---> SECL:x    (1=yes 0=no)
  240.      Hash USERS to keep msgs while purging ----> USRH:x    (1=yes 0=no)
  241.      Capture messages with special text -------> CAPT:x    (1=yes 0=no)
  242.      Enable Duplicate Checking for AREA -------> CDUP:x    (1=yes 0=no)
  243.      Set Mailwaiting Bits for new RBBS msgs ---> MWST:x    (1=yes 0=no)
  244.      Maintain history file of purged messages -> HIST:x    (1=yes 0=no)
  245.      Zone & Domain Separation (1=none 2=full) -> GATE:x    (1  or 2)
  246.      Origin: line to be used for scanning -----> ORGN:text (last entry)
  247.  
  248.      NOTE: Some  of  these  Keywords are quite critical and  should  be
  249.            throughly   understood   PRIOR  to  attempting   MSGTOSS.BBS
  250.            configuration.  The most critical Keywords are as follows:
  251.  
  252.      NODE:xxxx RECS:xxxx, ESEC:xxxx, GATE:xxxx, FMAS:x, SECL:x, USRH:x
  253.  
  254.      *************************** WARNING! ****************************
  255.      * Read the documentation on the above critical Keywords PRIOR   *
  256.      * to configuring the default Keywords in the MSGTOSS.BBS file.  *
  257.      * Setting them incorrect will throughly screw things up!!       *
  258.      *****************************************************************
  259.  
  260.                                    Page - 4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                          MSGTOSS.BBS Reference Manual
  267.  
  268.  
  269.      These keywords are placed on a line PRECEDING the affected RBBS or
  270.      Fido-style   conference.   If  the  FIRST  character  of  a   line
  271.      in the MSGTOSS.BBS is a "-" (dash) then MSGTOSS will consider that
  272.      line  a keyword line and attempt to parse it to obtain conference-
  273.      specific  (or  global) keywords.   Note that mail tossers such  as
  274.      CONFMAIL & RBBSMAIL will (should) politely ignore these "-" lines.
  275.  
  276.      Non-Keywords  that  happen to be present on Keyword lines will  be
  277.      ignored, allowing comments or other mail processors who use a sim-
  278.      ilar scheme (like MREN) to also use these lines.
  279.  
  280.      All of these keywords are "global"  until changed. For example, if
  281.      "MRGN:77"  is entered at the top of the MSGTOSS.BBS file, then all
  282.      subsequent  conferences  will be formatted with a right margin  of
  283.      77.  If however,  you want a particular conference to be formatted
  284.      with  a  right  margin of 39 (maybe for 40  column  machines  like
  285.      Commodore 64's) then an entry such as "-MRGN:39"  should be placed
  286.      on a line just PRIOR to the affected conference.
  287.  
  288.      Example:
  289.  
  290.      -MRGN:39
  291.      C:\RBBS\COMOM.DEF    COMMODORE_64    1:343/300
  292.      -MRGN:77
  293.  
  294.      Notice  that these keywords begin with a "-".   All of these  key-
  295.      words apply to ALL SUBSEQUENT conferences,  until you change them.
  296.      For instance.   If you want the MAIN message base to NOT be hashed
  297.      for  users during a purge,  simply add the keyword "-USRH:0"  just
  298.      before the line entry for C:\RBBS\MESSAGES. 
  299.  
  300.      Example:
  301.  
  302.      -USRH:0
  303.      C:\RBBS\MESSAGES        NETMAIL
  304.      -USRH:1
  305.  
  306.      Remember, for all SUBSEQUENT conferences the "-USRH:0" will apply,
  307.      so  if  you want it for ONLY the main message base,  then turn  it
  308.      back  on immediately after the C:\RBBS\MESSAGES line with  another
  309.      "-USRH:1" entry!
  310.  
  311.      Unless  any of these are changed by either a single keyword  entry
  312.      on a single line, such as:
  313.  
  314.      -RECS:2000
  315.  
  316.      Or multiple entries on a single line:
  317.  
  318.      -RECS:3000 MAXL:99 RNIF:1
  319.  
  320.      They  remain  in effect for all subsequent conferences until  they
  321.      are changed.
  322.  
  323. -----------------------------------------------------------------------
  324.  
  325.  
  326.                                    Page - 5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                          MSGTOSS.BBS Reference Manual
  333.  
  334.  
  335. MSGTOSS.BBS SECTIONS
  336. --------------------
  337.  
  338. The MSGTOSS.BBS is made up of 5 sections,  the DEFAULT ORIGIN LINE, the
  339. MESSAGE  BASE (or FIDO DIRECTORY),  the official domain AREA NAME,  and
  340. the NET/NODE listing.   As stated earlier,  the MSGTOSS.BBS file should
  341. be compatible with other mail processors.
  342.  
  343. Lines beginning with:
  344.  
  345. "-" are MSGTOSS keyword lines (comments to other mail processors)
  346. ";" are comments, and will be ignored
  347. "#" is a PASSTHRU Area
  348. " " (spaces) will be stripped of leading spaces, then processed.
  349. ""  (blank) are ignored
  350.  
  351. For  instance,  PASSTHRU areas (Qmail Style) are supported by  MSGTOSS,
  352. and usually have the following appearance in a Qmail AREAS.BBS
  353.  
  354. #C:\MAIL\RBBS       RBBS-PC   343/300
  355.  C:\MAIL\COMM       COMM      343/36
  356.  
  357. The  leading  space  will be stripped in the second entry  by  MSGTOSS,
  358. leaving the lined-up appearance of the PATHS for easy editing.
  359.  
  360. The CASE of the entries is of no concern as MSGTOSS will store all data
  361. in memory as upper case.
  362.  
  363.  
  364.      DEFAULT ORIGIN LINE
  365.      -------------------
  366.      The  FIRST un-commented line in MSGTOSS.BBS is always the  default
  367.      Origin: line.
  368.  
  369.      Example:
  370.  
  371.      INTERSTATE BBS NETWORK - Seattle, WA ! Mike Zakharoff
  372.  
  373.      The "!", followed by the sysops name is optional, MSGTOSS does not
  374.      require this,  as it gets the sysop name from the FIRST SYSNAME---
  375.      -->  entry  in the MSGTOSS.CFG file when used for  exporting  mes-
  376.      sages.
  377.  
  378.      See SYSNAME-----> in MSGCFG.REF for more information on this.
  379.  
  380.      The Length of the Origin line matters,  as MSGTOSS will attempt to
  381.      tell  you  that your Origin line is too long when doing a  "/TEST"
  382.      during system set-up.   Along with ZONE:NET/NODE,  the Origin line
  383.      should be less than 79 characters.
  384.  
  385.      NOTE: Special  origin  lines can be configured via  the  ORGN:text
  386.            keyword.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                    Page - 6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                          MSGTOSS.BBS Reference Manual
  399.  
  400.  
  401.  
  402.      RBBS (M.DEF) AREAS
  403.      -------------------
  404.      The  RBBS message base (or Fido-style directory) is the first item
  405.      entered on a normal conference line in MSGTOSS.BBS.
  406.  
  407.      All  of the RBBS conferences MUST contain an 'M.DEF'  to be recog-
  408.      nized, and MUST have a matching 'U.DEF' users file in the same di-
  409.      rectory.   The  exception here is that if you use the message file
  410.      "MESSAGES",  MSGTOSS will assume a user file called "USERS" in the
  411.      same directory.
  412.  
  413.      Example:
  414.  
  415.      -RECS:1000
  416.      C:\RBBS\RBBSM.DEF     RBBS-PC   1:343/300
  417.  
  418.      Would assume a matching user file in C:\RBBS\ called RBBSU.DEF.
  419.  
  420.      All  RBBS Conferences require a "-RECS:xxxx"  value to apply where
  421.      the  xxxx is the size in (128 byte) RECORDS of that message  base.
  422.      The  xxxx  will be the size the message base is CHOPPED back  down
  423.      (or INCREASED) to when using the '/SIZE'  or '/SIZE-UP'  switches,
  424.      respectively.
  425.  
  426.      NOTE: Read  documentation  on  RECS:xxxx for more  information  on
  427.            this.
  428.  
  429.      NOTE: Executing  "MSGTOSS /STAT"  provides message base statistics
  430.            for all RBBS message bases.  This includes the current sizes
  431.            (in RECS:xxx) that may be used for easy settings.
  432.  
  433.      In  the  above  example,  the  "RECS:1000"  entry  indicates  that
  434.      RBBSM.DEF contains 1000 records.
  435.  
  436.      NOTE: Actual size (in bytes) of the message bases is (xxxx * 128)
  437.  
  438.      Although the above example has a RECS:xxxx keyword line immediate-
  439.      ly  preceding it,  this is usually not necessary,  as a previously
  440.      defined  RECS:xxxx keyword is probably already active.   These are
  441.      only  required  when  its  desirable for  the RECS:xxxx  value  to
  442.      change.   For instance,  the following example,  although it would
  443.      work properly,  is considered un-professional (heaven forbid), and
  444.      would slow down initialization:
  445.  
  446.      -RECS:1000
  447.      C:\RBBS\COMMM.DEF     COMM      1:343/300
  448.      -RECS:1000
  449.      C:\RBBS\RBBSM.DEF     RBBS-PC   1:343/300
  450.      -RECS:1000
  451.      C:\RBBS\4SALEM.DEF    4SALE     1:343/300
  452.      -RECS:1000
  453.      C:\RBBS\COOKM.DEF     COOKING   1:343/300
  454.  
  455.      NOTE: When you execute a /STAT or /TEST major command line switch,
  456.            MSGTOSS  will loudly complain if these RECS:xxx entries  are
  457.  
  458.                                    Page - 7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                          MSGTOSS.BBS Reference Manual
  465.  
  466.            incorrect.   You  can then correct them.   For more informa-
  467.            tion,  see  /TEST  & /STAT in MSGSWI.DOC,  and  INSTALLATION
  468.            'Test System Setup' in MSGTOSS.DOC.
  469.  
  470.      TIP: Place  all similar sized RBBS message bases together, so  you
  471.           can have just one "-RECS:xxx" entry that will apply for them.
  472.  
  473.      NOTE: The  old  "|R999|"  (in  pre-version  2.0)  will  not  work.
  474.            Configure these on a preceding line as "-RECS:999"
  475.  
  476.  
  477.      FIDO (#.MSG) AREAS
  478.      ------------------
  479.      If  the  conference  line doesn't  contain  either  "MESSAGES"  or
  480.      "M.DEF",  it  is automatically considered to be a FIDO-style area,
  481.      and MSGTOSS will attempt to verify its existence.  It is important
  482.      to  know that MSGTOSS requires that EACH Fido subdirectory must be
  483.      unique!   MSGTOSS  will  not  allow  intermixing  of  Fido  Areas,
  484.      and will abort with an error.
  485.  
  486.      You  CAN have BOTH an RBBS conference (as above) AND a FIDO  style
  487.      conference for the SAME AREA.
  488.  
  489.      Example:
  490.  
  491.      You  want to post the RBBS-PC conference for users AND  have  them
  492.      tossed  into Fido Style also,  where you could use an editor (such
  493.      as MSGED) for your own personal use.
  494.  
  495.      C:\RBBS\commm.def   COMM  1:343/300
  496.      C:\MAIL\COMM\       COMM  (no Net/Nodes listed on second item)
  497.  
  498.      NOTE: MSGTOSS 2.0+  provides  a  notable feature  called  "mirror-
  499.            scanning",  where if you have a double-tossed area (as noted
  500.            above), then if a user entered a message in the RBBS confer-
  501.            ence,  when exported, will also create a "carbon copy", com-
  502.            plete  with  Origin:  line,  in the Fido-Style directory  as
  503.            well.   The same applies to when a user (or yourself) enters
  504.            a  message in a Fido-Style conference,  when exported,  will
  505.            create a carbon copy in the RBBS message base.
  506.  
  507.      Don't  go crazy with simultaneous (RBBS + FIDO) conferences,  they
  508.      will  drastically  slow down tossing.   Tossing is  optimized  for
  509.      tossing into RBBS conferences, and this feature is provided simply
  510.      for convenience.
  511.  
  512.  
  513.      AREA NAME
  514.      ---------
  515.      The  entry  following the RBBS message base is the  official  AREA
  516.      name,  as defined by your favorite domain (Fidonet, Rbbs-Net, Egg-
  517.      Net).  Nothing fancy here, case does not matter.
  518.  
  519.      NOTE: MSGTOSS  has hard-coded special area names.   See section on
  520.            "Special Areas" in this document
  521.  
  522.  
  523.  
  524.                                    Page - 8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                          MSGTOSS.BBS Reference Manual
  531.  
  532.      NODES LISTING
  533.      -------------
  534.      The Nodes listed to the right are those which you are either FEED-
  535.      ING  (if  you are a HUB) or your HUB that you exchange mail  with.
  536.      If  you are using MSGTOSS to FEED your nodes (You are either a HUB
  537.      --or--  you service points) then you use the /FEED switch during a
  538.      toss.
  539.  
  540.      For the LIST of net/nodes, the following apply:
  541.  
  542.         1) The  ZONE  and  DOMAIN  are the  same  as  the  "NODE----->"
  543.            entry (MSGTOSS.CFG)  that  corresponds  to  the  NODE:x  BBS
  544.            keyword.
  545.  
  546.         2) You can change the ZONE entry on this line, and ...
  547.  
  548.         3) You can add "@domain" on the line also.
  549.  
  550.  
  551.      Example:
  552.  
  553.      1:343/300 36 666/1 2 3
  554.      1:343/300@fidonet 301 302 8:8/1@rbbs-net 4 5 918/10 20
  555.      343/300 36 37 38
  556.      918/1 2 3
  557.  
  558.      NOTE: If the Zone is omitted from the list of nodes,  MSGTOSS will
  559.            figure it out from its own nodelist.
  560.  
  561.      NOTE: The  FIRST  unique  AREA:  entry  determines  the  NET/NODES
  562.            that are fed  or exported.
  563.  
  564.            Example:
  565.  
  566.            C:\RBBS\commm.def   COMM  1:343/300
  567.            C:\MAIL\COMM\       COMM  1:343/300 301 555/666 4 5
  568.                                      ^^^^^^^^^^^^^^^^^^^^^^^^^
  569.                                      second nodelist Ignored!
  570.  
  571.             Note  that the FIRST sequential entry (only) counts,  so if
  572.             you append new NET/NODE information to the second entry, it
  573.             will be ignored!   This ONLY applies to "double tossed" ar-
  574.             eas  (as  the above example) where the same AREA  is  being
  575.             tossed to both #.MSG and M.DEF format.
  576.  
  577. -----------------------------------------------------------------------
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                    Page - 9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                          MSGTOSS.BBS Reference Manual
  597.  
  598.  
  599. SAMPLE MSGTOSS.BBS FILE
  600. -----------------------
  601.  
  602. INTERSTATE BBS Seattle WA ! Mike Zakharoff
  603. ;
  604. ; Default keyword entries
  605. ;
  606. -RECS:1000 RNST:1  RNIF:1 ESEC:5 MAXL:100 
  607. -SLAK:10   MRGN:77 FMAS:1 SECL:1 USRH:1 HIST:0
  608. -CAPT:0    NODE:1  GATE:2 PRIV:0 CDUP:0 MWST:1
  609. ;
  610. ;  NOTE: Some of these Keywords are quite critical and should be
  611. ;        throughly understood PRIOR to attempting MSGTOSS.BBS
  612. ;        configuration.  The most critical Keywords are as follows:
  613. ;
  614. ;        NODE:x RECS:xxxx ESEC:xxxx GATE:xxxx FMAS:x SECL:x USRH:x
  615. ;
  616. ; *************************** WARNING! ****************************
  617. ; * Read the documentation on the above critical Keywords PRIOR   *
  618. ; * to configuring the default Keywords in the MSGTOSS.BBS file.  *
  619. ; * Setting them incorrect will throughly screw things up!!       *
  620. ; *****************************************************************
  621. ;
  622. ; Note the NODE:1 entry!  This indicates that the following
  623. ; conferences are associated with your FIRST "NODE-------->"
  624. ; address in your MSGTOSS.CFG file.  NODE:2 would mean the
  625. ; SECOND NODE--------> entry, NODE:3 means THIRD.
  626. ;
  627. ; Turn off USER hashing for the main message base (USRH:0), as
  628. ; there are too many users for MSGTOSS to efficiently purge as
  629. ; required (its unnecessary).  Turn it back on after (USRH:1)
  630. ; for the rest of the small conferences.
  631. ;
  632. -USRH:0
  633. C:\RBBS\MESSAGES      NETMAIL
  634. -RECS:800 USRH:1
  635. ;
  636. ; All subsequent conferences are 800 records (RECS:800).
  637. ; Naturally, you will have to adjust these to match your system.
  638. ;
  639. C:\RBBS\commm.def     COMM          1:343/300
  640. C:\RBBS\consultm.def  CONSULTING    1:343/300
  641. C:\RBBS\cookingm.def  COOKING       1:343/300
  642. C:\RBBS\c_prgmm.def   C_ECHO        1:343/300
  643. C:\RBBS\feminm.def    FEMINISM      1:343/300
  644. C:\RBBS\forsalem.def  4SALE         1:343/300
  645. ;
  646. ; Special Origin line to apply ONLY to the NEXT sequential message base
  647. ;
  648. -ORGN:MSGTOSS - Accept no substitutes!
  649. C:\RBBS\rbbsm.def     RBBS-PC       1:343/300
  650. ;
  651. ; Default Origin line takes over
  652. ;
  653. C:\RBBS\techm.def     TECH          1:343/300
  654. C:\RBBS\warningm.def  WARNINGS      1:343/300
  655.  
  656.                                   Page - 10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                          MSGTOSS.BBS Reference Manual
  663.  
  664. ;
  665. ; Qmail-Style PASSTHRU areas are also supported, these have the
  666. ; following format:
  667. ;
  668. ; #[Optional Path]    PASSAREA 1:343/300 301 301 666/1 2 3
  669. ;
  670. ; Note that the FIRST character must be a "#", followed by the AREA:
  671. ; name, followed by the list of NET/NODES.  Note that the NET/NODES
  672. ; will ONLY be "fed" if you are using the "/FEED" switch.  Note that
  673. ; QMAIL requires a Fido Path to follow the "#", and this CAN be listed,
  674. ; but MSGTOSS will ignore the path.
  675. ;
  676. ; The areas NETMAIL   & UNKNOWN    are required.
  677. ; The areas ROUTETHRU & MSGCAPTURE are optional
  678. ; For each unique domain/zone, separate areas are required
  679. ; The extensions of ".001" & ".008" (meaning Zone 1 & 8)
  680. ; are for illustrative purposes only and are not necessary.
  681. ;
  682. C:\MAIL\NETMAIL.001\  NETMAIL
  683. C:\MAIL\UNKNOWN.001\  UNKNOWN
  684. ; C:\MAIL\ROUTEIT.001\  ROUTETHRU
  685. ; C:\MAIL\CAPTURE.001\  MSGCAPTURE
  686. ;
  687. C:\MAIL\NET343\       NET343        1:343/300
  688. C:\MAIL\RBBS.001\     RBBS-PC       1:343/300
  689. C:\MAIL\LAN\          LAN           1:343/300
  690. ;
  691. ; The -NODE:2 entry signifies the SECOND NODE--------> entry in
  692. ; the MSGTOSS.CFG file.  This keyword separates the MSGTOSS.BBS
  693. ; file into Domains/Zones.  -NODE:3 would mean the THIRD
  694. ; NODE--------> entry (if exist).
  695. ;
  696. ;
  697. -NODE:2                       (The second AKA is RBBS-NET!)
  698. C:\MAIL\NETMAIL.008\  NETMAIL
  699. C:\MAIL\UNKNOWN.008\  UNKNOWN
  700. ; C:\MAIL\ROUTEIT.008\  ROUTETHRU
  701. ; C:\MAIL\CAPTURE.008\  MSGCAPTURE
  702. ;
  703. C:\MAIL\MSGTOSS\      RBBS_MSGTOSS  8:918/1
  704. C:\MAIL\MSGBETA\      MSGBETA       8:918/1
  705. C:\MAIL\RBBS.008\     RBBS-PC       8:918/1
  706. ;
  707. ; Having two RBBS-PC conferences is not a misprint.  What separates
  708. ; them is the NODE:2 keyword, meaning the second RBBS-PC conference
  709. ; belongs to RBBS-NET (Zone 8).
  710.  
  711. -----------------------------------------------------------------------
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                   Page - 11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                          MSGTOSS.BBS Reference Manual
  729.  
  730.  
  731. SPECIAL AREAS
  732. -------------
  733.  
  734. MSGTOSS has hard-coded AREAS with special names, these are:
  735.  
  736. NETMAIL    - Where non-echomail (Netmail) is tossed
  737. UNKNOWN    - Where unidentified echomail is tossed 
  738. ROUTETHRU  - Where Netmail (not addressed to your AKAs) are tossed
  739. MSGCAPTURE - Where "captured" echomail is tossed
  740.  
  741. For  all  of the above,  separate directories must be defined for  each
  742. unique  Domain/Zone,  as indicated by your ZONETYPE----> entry in  your
  743. MSGTOSS.CFG.  Refer to MSGCFG.REF for detailed information.
  744.  
  745. NOTE: The  AREAs  NETMAIL  and  UNKNOWN are required  for  all  MSGTOSS
  746.       installations, where ROUTETHRU and MSGCAPTURE are optional.
  747.  
  748. Example:
  749.  
  750. -NODE:1              (The first  NODE--------> entry Zone:1)
  751. C:\MAIL\NETMAIL.001\  NETMAIL
  752. C:\MAIL\UNKNOWN.001\  UNKNOWN
  753. C:\MAIL\ROUTEIT.001\  ROUTETHRU      (optional)
  754. C:\MAIL\CAPTURE.001\  MSGCAPTURE     (optional) 
  755. ;
  756. -NODE:2              (The second NODE--------> entry Zone:8)
  757. C:\MAIL\NETMAIL.008\  NETMAIL
  758. C:\MAIL\UNKNOWN.008\  UNKNOWN
  759. C:\MAIL\ROUTEIT.008\  ROUTETHRU      (optional)
  760. C:\MAIL\CAPTURE.008\  MSGCAPTURE     (optional)
  761. ;
  762.  
  763. The areas UNKNOWN and NETMAIL are required as either an RBBS conference
  764. or  as a FIDO style conference.   Note that tossing these into an  RBBS
  765. conference (only) is a one way street.   Although MSGTOSS will be happy
  766. doing this, its serves no useful purpose.
  767.  
  768. NOTE: Placing Net/Node lists following these areas will do nothing,  as
  769.       MSGTOSS  will ignore them.   These areas should be Non-Echoed ar-
  770.       eas.
  771.  
  772. NOTE: The  areas  NETMAIL,  UNKNOWN  and ROUTETHRU (if  exist) will  be
  773.       exempt from dup and size checking, even if you specify CDUP:1.
  774.  
  775.      AREA:NETMAIL
  776.      ------------
  777.      NETMAIL  is required!   All non-echo mail will be tossed into this
  778.      area for users (and sysops) Netmail.   Recommended to be a double-
  779.      tossed area (both RBBS and FIDO-Style).  This is optional, but its
  780.      nice  having the MAIN message base listed,  as MSGTOSS's  internal
  781.      maintenance routines (such as SIZING, PURGING & MAILWAITING RESET)
  782.      will also apply.  Also if all NETMAIL is tossed into the main RBBS
  783.      message  base,  then users will be notified of their NETMAIL  (and
  784.      can read it).
  785.  
  786.      Example of double tossed NETMAIL AREA:
  787.  
  788.                                   Page - 12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                          MSGTOSS.BBS Reference Manual
  795.  
  796.  
  797.      C:\RBBS\MESSAGES    NETMAIL    (no nodes listed!)
  798.      C:\MAIL\NETMAIL.001 NETMAIL    (no nodes listed!)
  799.  
  800.      NOTE: Separate  directories  must be defined for NETMAIL for  each
  801.            unique Domain/Zone, as indicated by your ZONETYPE----> entry
  802.            in   your  MSGTOSS.CFG. Refer  to  MSGCFG.REF  for  detailed
  803.            information.
  804.  
  805.      AREA:UNKNOWN
  806.      ------------
  807.      UNKNOWN  is required!   This is where echomail,  whose areas  were
  808.      omitted  from  your MSGTOSS.BBS file will be tossed  when  MSGTOSS
  809.      can't  figure out where they go.   Recommended to be a  Fido-style
  810.      area  as you can toss the previously unknown (after you fixed  the
  811.      BBS file) using the "/TUNK"  (toss unknown) switch.  Messages with
  812.      UNKNOWN  areas  will be tossed into the specified directory  along
  813.      with the  original AREA:xxxx which was not recognized.
  814.  
  815.      NOTE: Separate  directories  must be defined for UNKNOWN for  each
  816.            unique Domain/Zone, as indicated by your ZONETYPE----> entry
  817.            in   your  MSGTOSS.CFG. Refer  to  MSGCFG.REF  for  detailed
  818.            information.
  819.  
  820.      AREA:MSGCAPTURE
  821.      ---------------
  822.      Note that MSGCAPTURE is optional.  This is the directory where (if
  823.      CAPT:x is true) all messages that contain target strings in accor-
  824.      dance with the "CAPTURE---->" entries (in MSGTOSS.CFG).  Note that
  825.      after  you  have done what you needed to these messages,  you  can
  826.      then  import  them into public areas by using  the  "/TCAP"  (toss
  827.      MSGCAPTURE) command line switch.
  828.  
  829.      NOTE: Read  documentation  on CAPT:x for more information on  this
  830.            feature.
  831.  
  832.      NOTE: Separate directories must be defined for MSGCAPTURE for each
  833.            unique Domain/Zone, as indicated by your ZONETYPE----> entry
  834.            in   your  MSGTOSS.CFG. Refer  to  MSGCFG.REF  for  detailed
  835.            information.
  836.  
  837.      AREA:ROUTETHRU
  838.      --------------
  839.      Note  that ROUTETHRU is optional.   All NETMAIL messages that  are
  840.      NOT  addressed to ANY of your AKA(s) (NODE------> entries) will be
  841.      tossed  into your NETMAIL area (which is required).   However,  if
  842.      you  have this special area called "ROUTETHRU",  then MSGTOSS will
  843.      toss  those  messages here instead.   This is useful for HUBS  who
  844.      want to control mail routing.
  845.  
  846.      NOTE: Separate  directories must be defined for ROUTETHRU for each
  847.            unique Domain/Zone, as indicated by your ZONETYPE----> entry
  848.            in   your  MSGTOSS.CFG. Refer  to  MSGCFG.REF  for  detailed
  849.            information.
  850.  
  851. -----------------------------------------------------------------------
  852.  
  853.  
  854.                                   Page - 13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.                          MSGTOSS.BBS Reference Manual
  861.  
  862.  
  863. PASSTHRU AREAS
  864. --------------
  865.  
  866. MSGTOSS supports Qmail-Style PASSTHRU areas,  these require the follow-
  867. ing format:
  868.  
  869. Example:
  870.  
  871. #[Optional Path]   RBBS-PC 1:343/300 301 301 666/1 2 3
  872.  
  873. Note  that  the FIRST character must be a "#",  followed by  the  AREA:
  874. name,  followed by the list of NET/NODES.  Note that the NET/NODES will
  875. ONLY be "fed" if you are using the "/FEED" switch.  Note that QMAIL re-
  876. quires  a  Fido Path to follow the "#",  and this CAN  be  listed,  but
  877. MSGTOSS will ignore the path.
  878.  
  879. NOTE: The  PASSTHRU  function will NOT work without the  /FEED  command
  880.       line switch.
  881.  
  882. -----------------------------------------------------------------------
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                   Page - 14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                          MSGTOSS.BBS Reference Manual
  927.  
  928.  
  929. Chain to the next BBS file  -  NBBS:[path]Filename.ext
  930. ------------------------------------------------------
  931.  
  932. NBBS:file - The next 'MSGTOSS.BBS'  file to "chain" to after processing
  933.             is complete with the current file.  This allows you to have
  934.             multiple AREAS.BBS files,  one or each ZONE.   MSGTOSS will
  935.             read all sequentially,  but will not allow one that has al-
  936.             ready been processed to be processed again (will abort).
  937.  
  938.             Example:
  939.  
  940.             -NBBS:C:\MSGTOSS\MSGTOSS.BB2
  941.  
  942.             The  NBBS  Keyword  allows the chaining of  multiple  *.BBS
  943.             files. The format is NBBS:filename.  NBBS may appear on any
  944.             of  the  control lines in the BBS file.   The current  file
  945.             that it appears in will be processed all the way to the end
  946.             before  MsgToss will look for the new file.   If more  than
  947.             one NBBS parameter appears in a BBS file, only the last one
  948.             will be honored.
  949.  
  950.             Possible uses:
  951.  
  952.             If you NEED to keep separate *.BBS files for separate ZONES
  953.             or domains, or you are using another mail processing utili-
  954.             ty  that  can't handle the multiple domain/zone *.BBS  file
  955.             that  MSGTOSS  uses,  or you just want to keep  a  separate
  956.             MSGTOSS.BBS  file  for maybe Fidonet and Rbbs-Net  (zone  1
  957.             & 8).
  958.  
  959. -----------------------------------------------------------------------
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                   Page - 15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.                          MSGTOSS.BBS Reference Manual
  993.  
  994.  
  995. No. of records in RBBS message base(s)  -  RECS:xxxx
  996. ----------------------------------------------------
  997.  
  998. RECS:xxx  - All  RBBS Conferences require "-RECS:xxxx"  to apply  where
  999.             the  xxx is the size in RECORDS of that message base.   The
  1000.             xxxx  will  be  the size the message base is  CHOPPED  back
  1001.             down  (or INCREASED) to when using the /SIZE (or  /SIZE-UP)
  1002.             switches when necessary.
  1003.  
  1004.             Example:
  1005.  
  1006.             -RECS:1000
  1007.             C:\RBBS\RBBSM.DEF    RBBS-PC      1:343/300
  1008.             C:\RBBS\COMMM.DEF    COMM         1:343/300
  1009.  
  1010.             -RECS:2000
  1011.             C:\RBBS\MSGTOSSM.DEF RBBS_MSGTOSS 1:343/300
  1012.  
  1013.             Means that the RBBS conferences RBBSM.DEF and COMMM.DEF are
  1014.             both  1000 records but MSGTOSSM.DEF conference is 2000  re-
  1015.             cords.
  1016.  
  1017.                  1000 records * 128  = 128,000 bytes
  1018.                  2000 records * 128  = 256,000 bytes
  1019.  
  1020.             NOTE: Actual size of the message bases is (xxxx * 128)
  1021.  
  1022.             Notice   how  another  RECS:1000  entry  IS  NOT   required
  1023.             for COMMM.DEF, as the previously entered one still applied.
  1024.  
  1025.             Whats the purpose of this?  When you preassign the sizes of
  1026.             the  message  bases as such,  MSGTOSS will know what  sizes
  1027.             they  are suppose to be,  allowing extremely easy SIZING of
  1028.             the  message bases.   No more need to use the clumsy CONFIG
  1029.             program  that  came with RBBS-PC.   All you need to  do  to
  1030.             change the size of message bases is to change the RECS:xxxx
  1031.             entries,  and issue one of the MSGTOSS SIZING command.  For
  1032.             instance:
  1033.  
  1034.             MSGTOSS /SIZE <rtn>
  1035.  
  1036.             Will CHOP message bases back down (but not up) if the sizes
  1037.             of  any  of them EXCEED the sizes as defined in the  RECS:x
  1038.             keywords.
  1039.  
  1040.             MSGTOSS /SIZE-UP <rtn>
  1041.  
  1042.             Will CHOP message bases back down AND INCREASE them (as re-
  1043.             quired) to match their associated RECS:xxx keywords.
  1044.  
  1045.             Why was such a wonderful utility included with MSGTOSS? Be-
  1046.             cause  MSGTOSS  will expand a message base (only if it  has
  1047.             to)  to  accommodate messages,  and one quick MSGTOSS  SIZE
  1048.             command line will restore them (maybe a daily event). 
  1049.  
  1050.             If  you  have  multiple sizes for your RBBS  message  bases
  1051.  
  1052.                                   Page - 16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.                          MSGTOSS.BBS Reference Manual
  1059.  
  1060.             (why?)  then you will have to have a different  "-RECS:xxx"
  1061.             entry before EACH RBBS-related line.
  1062.  
  1063.             NOTE: Place  all similar sized RBBS message bases together,
  1064.                   so you can have just one "-RECS:xxx"  entry that will
  1065.                   apply for them.
  1066.  
  1067.             NOTE: The  old  "|R999|"  will no longer  work!   Configure
  1068.                   these on a preceding line as "-RECS:999"
  1069.  
  1070. -----------------------------------------------------------------------
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.                                   Page - 17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.                          MSGTOSS.BBS Reference Manual
  1125.  
  1126.  
  1127. Re-number msg only if last exceed xxxx  -  RNIF:xxxx
  1128. ----------------------------------------------------
  1129.  
  1130. RNIF:xxx  - During  an  internal purge,  will re-number,  BUT  ONLY  IF
  1131.             the last  message number of the message base (Prior to  the
  1132.             purge) is GREATER (or EQUAL) to the RNIF:xxx value.
  1133.  
  1134.             Example:
  1135.  
  1136.             -RECS:1000 RNST:1  RNIF:500
  1137.             C:\RBBS\RBBSM.DEF      RBBS-PC      1:343/300
  1138.             C:\RBBS\COMMM.DEF      COMM         1:343/300
  1139.  
  1140.             So  in this case MSGTOSS will execute internal re-numbering
  1141.             on the above conferences, but only IF their LAST message is
  1142.             greater than (or equal) to 500.   Incidentally, the re-num-
  1143.             bering  will start with "1",  as defined by the RNST:1 key-
  1144.             word.
  1145.  
  1146.             When  MSGTOSS  purges messages MSGTOSS will check  to  make
  1147.             sure  that  last message entered in the message base is  >=
  1148.             RNIF:xxx, otherwise MSGTOSS will simply skip re-numbering.
  1149.  
  1150.             NOTE: This  is  used in conjunction with the RNST:xxx  (re-
  1151.                   number start) keyword.
  1152.  
  1153.             NOTE: MSGTOSS  will automatically reset the "last message -
  1154.                   read"  entry  in the associated USERS(s) file to  the
  1155.                   NEW  message number -or- the next closest NEW message
  1156.                   number, so last-read pointers will NOT be lost.
  1157.  
  1158.             This  works like its little cousin,  MSGRENUM (Version 1.4,
  1159.             Mike Zakharoff, available as MSGREN14.xxx).
  1160.  
  1161. -----------------------------------------------------------------------
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.                                   Page - 18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                          MSGTOSS.BBS Reference Manual
  1191.  
  1192.  
  1193. Re-number msg bases starting with  -  RNST:xxxx
  1194. -----------------------------------------------
  1195.  
  1196. RNST:xxx  - Re-numbering  of  messages (during an internal purge)  will
  1197.             START with this number...
  1198.  
  1199.             Example:
  1200.  
  1201.             -RECS:1000 RNST:1000
  1202.             C:\RBBS\RBBSM.DEF      RBBS-PC      1:343/300
  1203.             C:\RBBS\COMMM.DEF      COMM         1:343/300
  1204.  
  1205.             When  MSGTOSS  purges messages then MSGTOSS will  make  the
  1206.             FIRST  message  of the message base start with  the  number
  1207.             1000, next is 1001, 1002, etc.
  1208.  
  1209.             NOTE: Recommended to be set to "1".
  1210.  
  1211.             NOTE: MSGTOSS  will automatically reset the "last message -
  1212.                   read"  entry  in the associated USERS(s) file to  the
  1213.                   NEW  message number -or- the next closest NEW message
  1214.                   number, so last-read pointers will NOT be lost.
  1215.  
  1216.             This  works like its little cousin,  MSGRENUM (Mike Zakhar-
  1217.             off).
  1218.  
  1219. -----------------------------------------------------------------------
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                   Page - 19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.                          MSGTOSS.BBS Reference Manual
  1257.  
  1258.  
  1259. Security level of tossed messages set to  -  ESEC:xxxx
  1260. ------------------------------------------------------
  1261.  
  1262. ESEC:xxx  - ESEC:xxx  sets  the  security level of the  message  during
  1263.             tossing,  and  during  purging as users with  the  security
  1264.             level   of ESEC:xxx or higher will not have their  messages
  1265.             deleted.
  1266.  
  1267.             Example:
  1268.  
  1269.             -RECS:1000 ESEC:5
  1270.             C:\RBBS\RBBSM.DEF      RBBS-PC      1:343/300
  1271.             C:\RBBS\COMMM.DEF      COMM         1:343/300
  1272.  
  1273.             Means  that  these two conferences (and ones  that  follow)
  1274.             will have the messages tossed into them to a security level
  1275.             of "5".
  1276.  
  1277.  *READ* --> NOTE: If you set ESEC:xx higher than the SYSOPS level, then
  1278.                   even YOU won't be able to read messages tossed.  This
  1279.                   is a VERY IMPORTANT keyword!
  1280.  
  1281. -----------------------------------------------------------------------
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.                                   Page - 20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                          MSGTOSS.BBS Reference Manual
  1323.  
  1324.  
  1325. The "home" NODE address for the echo  -  NODE:xxxx
  1326. --------------------------------------------------
  1327.  
  1328. NODE:x    - The "home" node address for the echo area. This      switch
  1329.             determines  the  domain and zone to which the echo  belongs
  1330.             and identifies which of your AKA addresses will be used for
  1331.             the origin lines generated during a /SCAN.   NODE:1 selects
  1332.             your primary address, NODE:2 your first AKA, etc.
  1333.  
  1334.             NOTE: The  order  of the NODE:x entries must coincide  with
  1335.                   the  NODE-------->  entries in your MSGTOSS.CFG  file
  1336.                   (very important!).
  1337.  
  1338.             Example:
  1339.  
  1340.             You belong to two domains (Fidonet and Rbbs-Net),  as shown
  1341.             in your MSGTOSS.CFG file:
  1342.  
  1343.             NODE-------->1:343/36.0@fidonet  (NODE:1) primary  <---+
  1344.   +------>  NODE-------->8:918/11.0@rbbs-net (NODE:2) AKA          |
  1345.   |                                                                |
  1346.   |         And your MSGTOSS.BBS file contains BOTH Fidonet and    |
  1347.   |         RBBS conferences, as shown:                            |
  1348.   |                                                                |
  1349.   |         -NODE:1                                         \      |
  1350.   |         C:\RBBS\RBBS1M.DEF     RBBS-PC      1:343/300    >-----+
  1351.   |         C:\RBBS\COMMM.DEF      COMM         1:343/300   /
  1352.   |
  1353.   |    /    -NODE:2
  1354.   +---<     C:\RBBS\RBBS8M.DEF     RBBS-PC      8:918/1
  1355.        \    C:\RBBS\MSGTOSSM.DEF   RBBS_MSGTOSS 8:918/1
  1356.  
  1357.             The first two conferences are linked to the primary address
  1358.             (1:343/36) via the NODE:1 keyword,  and the second two con-
  1359.             ferences are linked to the second address via the NODE:2
  1360.             keyword.
  1361.  
  1362.             Notice  that  the RBBS-PC conference is listed  two  times,
  1363.             once for Fidonet and Rbbs-Net.   This is totally valid, and
  1364.             MSGTOSS should be able to keep them totally separate.  Note
  1365.             also  that  this would cause other mail processors go  bon-
  1366.             kers,  so if you plan on sharing your MSGTOSS.BBS file with
  1367.             other processes then you may not want to do this.
  1368.  
  1369. ****************************** IMPORTANT!! ****************************
  1370. *  The NODE:x entries MUST coincide with the NODE--------> entries    *
  1371. *  in your MSGTOSS.CFG file.   For instance, if your FIRST NODE entry *
  1372. *  is:                                                                *
  1373. *                                                                     *
  1374. *  NODE------->1:343/36.0@fidonet                                     *
  1375. *                                                                     *
  1376. *  Then you must have a NODE:1 ("1" meaning your FIRST NODE-------->  *
  1377. *  entry) which informs MSGTOSS that these conferences are associated *
  1378. *  with this NODE-------> entry.                                      *
  1379. *                                                                     *
  1380. *  NOTE: Failure to set these correct will screw up the * Origin:     *
  1381.  
  1382.                                   Page - 21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.                          MSGTOSS.BBS Reference Manual
  1389.  
  1390. *        lines during an export!                                      *
  1391. *                                                                     *
  1392. *  NOTE: Once you configure these NODE entries you should avoid       *
  1393. *  changing the ORDER of these entries unless you simultaneously      *
  1394. *  change both at the same time.                                      *
  1395. *                                                                     *
  1396. *  Remember, remember, remember...  These two items (NODE-------> &   *
  1397. *  NODE:x) are linked and MUST be configured properly.                *
  1398. *                                                                     *
  1399. ***********************************************************************
  1400.  
  1401. -----------------------------------------------------------------------
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.                                   Page - 22
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                          MSGTOSS.BBS Reference Manual
  1455.  
  1456.  
  1457. Max lines before MSGTOSS auto-breaks msg  -  MAXL:xxxx
  1458. ------------------------------------------------------
  1459.  
  1460. MAXL:xxx  - If  set to say 99,  MSGTOSS will toss (for extremely  large
  1461.             messages) in 99 line chunks, and then create a new message,
  1462.             appending  "MSGTOSS  (continued on NEXT  message)"  to  the
  1463.             bottom of the message.  Since the maximum message length is
  1464.             150 lines in RBBS, recommend this be set to at least 99.
  1465.  
  1466.             Example:
  1467.  
  1468.             -RECS:1000 MAXL:99
  1469.             C:\RBBS\RBBSM.DEF      RBBS-PC      1:343/300
  1470.             C:\RBBS\COMMM.DEF      COMM         1:343/300
  1471.  
  1472.             Means  that  these two conferences (and ones  that  follow)
  1473.             will  auto-break messages if they exceed 99 lines into mul-
  1474.             tiple messages (99 line chunks).
  1475.  
  1476.             If  MAXL:  is set to say 99,  then MSGTOSS will take an ex-
  1477.             tremely long message and break it up to 99 line chunks.  As
  1478.             you know, MSGTOSS can import a whole BOOK into M.DEF's, but
  1479.             unfortunately  RBBS is only capable of displaying 150 lines
  1480.             max (wonderful planning).   Setting MAXL:xx to say 100 will
  1481.             allow it to be fully read.
  1482.  
  1483.             In addition,  when MSGTOSS breaks up a message, it will ap-
  1484.             pend ....
  1485.  
  1486.             MSGTOSS (continued on NEXT message)   to bottom of message
  1487.             MSGTOSS (continued from LAST message) to top of next...
  1488.  
  1489.             The  purpose  of this is to allow the SCANNING code to  re-
  1490.             build the message for export if necessary.
  1491.  
  1492.             NOTE: During  a Re-Scan (/RSCAN:  switch,  applies ONLY  to
  1493.                   HUBS),  MSGTOSS  will do its best to "re-create"  the
  1494.                   original message which was broken up due to MAXL:x.
  1495.  
  1496.             ************************ WARNING! *************************
  1497.  
  1498.             If you use another message utility to export mail from RBBS
  1499.             (like  RBBSMAIL)  then  DON'T  use  this  feature!!    With
  1500.             RBBSMAIL  you may be safe by using the FMAS:1 keyword,  but
  1501.             others will probably cause problems.  Why use RBBSMAIL any-
  1502.             way???? (?<>^%$#@!)
  1503.  
  1504. -----------------------------------------------------------------------
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.                                   Page - 23
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.                          MSGTOSS.BBS Reference Manual
  1521.  
  1522.  
  1523. Min free messages if overflow condition  -  SLAK:xxxx
  1524. -----------------------------------------------------
  1525.  
  1526. SLAK:xxxx - When  MSGTOSS does an internal purge,  MSGTOSS will  always
  1527.             make  sure that the number of messages left in the  message
  1528.             base  is always LESS than ( RBBS-MAX-----> minus  SLAK:xxxx
  1529.             ).   This  helps  prevent  the possibility  of  "overflows"
  1530.             beyond the RBBS  maximum of 999 (RBBS-MAX) messages.
  1531.  
  1532.             Example:
  1533.  
  1534.             -RECS:1000 SLAK:10
  1535.             C:\RBBS\RBBSM.DEF      RBBS-PC      1:343/300
  1536.             C:\RBBS\COMMM.DEF      COMM         1:343/300
  1537.  
  1538.             The SLAK keyword sets the number of open message numbers to
  1539.             leave  at  the end of a conference.   The default value  is
  1540.             10.  When tossing mail,  MsgToss will compute the resulting
  1541.             number  of  messages for the conference  (current  messages
  1542.             plus  new  messages) and compare that to RBBSMAX.   If  the
  1543.             total  message count is greater than RBBSMAX minus SLAK,  a
  1544.             purge will be forced.   This virtually eliminates <knock on
  1545.             wood> the  possibility of an "overflow"  beyond the RBBSMAX
  1546.             value.
  1547.  
  1548. -----------------------------------------------------------------------
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.                                   Page - 24
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                          MSGTOSS.BBS Reference Manual
  1587.  
  1588.  
  1589. Format right margin of RBBS messages to  -  MRGN:xx
  1590. ---------------------------------------------------
  1591.  
  1592. MRGN:xx   - What   right margin should the RBBS conferences  should  be
  1593.             set to.    RBBS normally formats newly entered messages  to
  1594.             72.      It     should   be   noted   that   setting    the
  1595.             right margin beyond the RBBS expected value of 72 may cause
  1596.             editing   to  be  more  difficult,   but  will   make   the
  1597.             messages   more pleasing to read.  Values beyond 77 are not
  1598.             recommended.    A   value  of 39 can be used to format  the
  1599.             message bases  to  support 40 column users.
  1600.  
  1601.             Example:
  1602.  
  1603.             -RECS:1000 MRGN:77
  1604.             C:\RBBS\RBBSM.DEF              RBBS-PC  1:343/300
  1605.  
  1606.             -MRGN:39
  1607.             C:\RBBS\COMMM.DEF              COMMODORE_64  1:343/300
  1608.             -MRGN:77
  1609.  
  1610.             Note  that only for the COMMODORE_64 conference,  the right
  1611.             margin will be formatted to 39 characters,  but immediately
  1612.             after its set back to 77.
  1613.  
  1614.  
  1615.             NODE: Valid entries are 30 through 79
  1616.  
  1617.             NOTE: If not supplied, a default of 72 will be used
  1618.  
  1619. -----------------------------------------------------------------------
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.                                   Page - 25
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                          MSGTOSS.BBS Reference Manual
  1653.  
  1654.  
  1655. Whether to honor PRIVATE ECHOMAIL msgs  -  PRIV:x
  1656. -------------------------------------------------
  1657.  
  1658. PRIV:x    - During /TOSS (importing mail):
  1659.  
  1660.                Whether  to honor incoming PRIVATE   echomail.  Normally
  1661.                set      "0"  (or blank),   which  converts  to  public.
  1662.                Setting to "1"  will slow down tossing.  If tossing NET-
  1663.                MAIL into an RBBS conference then MSGTOSS will AUTOMATI-
  1664.                CALLY  check  it the message is private.   Better to set
  1665.                this switch to "0".
  1666.  
  1667.                If  PRIV:1 is set,  MSGTOSS will check if the message is
  1668.                private  (private  echomail DOES exist) and if  so  will
  1669.                make the message private in the M.DEF conference.
  1670.  
  1671.             During /SCAN (exporting mail):
  1672.  
  1673.                Also used to honor OUTGOING private messages.
  1674.  
  1675.                For exporting messages, the following rules apply:
  1676.  
  1677.                If COMMENT will not be exported (ever)
  1678.                If PRIVATE and TO:SYSOP will not be exported
  1679.                If PRIVATE and TO:USER and PRIV:1 then export (priv set)
  1680.                If PRIVATE and TO:USER and PRIV:0 then DON'T export
  1681.  
  1682.  
  1683.             Example:
  1684.  
  1685.             -RECS:1000 PRIV:0
  1686.             C:\RBBS\RBBSM.DEF      RBBS-PC       1:343/300
  1687.  
  1688. -----------------------------------------------------------------------
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.                                   Page - 26
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                          MSGTOSS.BBS Reference Manual
  1719.  
  1720.  
  1721. Force Msgs to M.DEFs as Already Scanned  -  FMAS:x
  1722. --------------------------------------------------
  1723.  
  1724. FMAS:x    - Force Mail As Scanned.    Will set the second colon of  the
  1725.             TIME   field  to a '.'   vice ':'.   This is the  "marking"
  1726.             mechanism MSGTOSS (and RBBSMAIL,  if used) uses to say that
  1727.             the message is NOT to be exported,  or has already been ex-
  1728.             ported.
  1729.  
  1730.             Example:
  1731.  
  1732.             -RECS:1000 FMAS:1
  1733.             C:\RBBS\RBBSM.DEF      RBBS-PC       1:343/300
  1734.  
  1735.             NOTE: There  is  really NO GOOD REASON to have this set  to
  1736.                   "0",  unless you insist on using another mail proces-
  1737.                   sor to export from RBBS conferences (like RBBSMAIL).
  1738.  
  1739.             ************************* WARNING! ************************
  1740.             * Setting FMAS:0 and using MSGTOSS will cause MSGTOSS to  *
  1741.             * happily reexport your mail back to your host!  Again,   *
  1742.             * this is a special purpose switch that you might as well *
  1743.             * forget about it (leave it set to FMAS:1) unless you     *
  1744.             * want to catch hell.                         *
  1745.             ***********************************************************
  1746.  
  1747.             Newly entered messages (local) have the second colon of the
  1748.             TIME to be a colon (as it should).    After MSGTOSS exports
  1749.             a message,  it will change it to a "." (period).   If /FEED
  1750.             command line switch is used,  FMAS:x will be forced to "On"
  1751.             for all echo areas.
  1752.  
  1753.             NOTE: Carefully  UNDERSTAND  the effects of this switch  if
  1754.                   you  set it to be null (FMAS:0).   It should NEVER be
  1755.                   null if you use MSGTOSS to export mail from RBBS mes-
  1756.                   sage bases.  If you do, then MSGTOSS will happily re-
  1757.                   export all messages BACK to the host!   The only REAL
  1758.                   reason  to set to null would be if you planned to use
  1759.                   RBBSMAIL  to  "FEED"  downstream  nodes  (not  recom-
  1760.                   mended).
  1761.  
  1762. -----------------------------------------------------------------------
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.                                   Page - 27
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.                          MSGTOSS.BBS Reference Manual
  1785.  
  1786.  
  1787. Strip Echo Control Lines (Only FMAS:1)  -  SECL:x
  1788. -------------------------------------------------
  1789.  
  1790. SECL:x    - Strip  Echomail Control Lines.    This switch CAN  ONLY  be
  1791.             used  in conjunction with the FMAS:1 switch,  as  explained
  1792.             above.   Basically, if you are using the FMAS:1 switch, you
  1793.             are  telling  MSGTOSS to don't bother  exporting   echomail
  1794.             that has already been tossed to RBBS conferences.   If this
  1795.             is  the  case  then why bother importing  echomail  control
  1796.             lines such as SEEN-BY:,  PATH:   and  other lines.   Using
  1797.             this   feature  will  DRASTICALLY  improve  the  number  of
  1798.             messages allowed to be imported in a given message base, as
  1799.             SEEN-BY: lines can use large amounts of disk space.
  1800.  
  1801.             Example:
  1802.  
  1803.             -RECS:1000 SECL:1
  1804.             C:\RBBS\RBBSM.DEF      RBBS-PC       1:343/300
  1805.  
  1806.             In your MSGTOSS.CFG file, set:
  1807.  
  1808.             SECL-------->SEEN-BY:
  1809.             SECL-------->
  1810.  
  1811.             Will  strip  all occurrences of  SEEN-BY:,  EID:,  PATH:,
  1812.             MSGID: & VIA:, and other lines beginning with ^a in  RBBS
  1813.             messages.
  1814.  
  1815.             NOTE: The   most restrictive entry will override a  similar
  1816.                   less restrictive entry, example:
  1817.  
  1818.                   SECL-------->
  1819.                   SECL-------->PATH:
  1820.  
  1821.             The first entry ALREADY will strip the second entry!
  1822.  
  1823.             NOTE: Also   see  SECL-------->  in  MSGCFG.REF  for   more
  1824.                   information.
  1825.  
  1826.             NOTE: During  a re-scan (/RSCAN:xxx,  for HUBS) of an  RBBS
  1827.                   message  base,  MSGTOSS will automatically IGNORE ex-
  1828.                   isting SEEN-BY:  and PATH:  lines anyway,  and simply
  1829.                   create  TINY control lines.   Therefore the ONLY real
  1830.                   reason  to NOT use this switch is where you are using
  1831.                   ANOTHER  mail exporter (like RBBSMAIL) that  requires
  1832.                   complete SEEN-BY and PATH: lines.
  1833.  
  1834. -----------------------------------------------------------------------
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.                                   Page - 28
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.                          MSGTOSS.BBS Reference Manual
  1851.  
  1852.  
  1853. Hash USERS to keep msgs while purging  -  USRH:x
  1854. ------------------------------------------------
  1855.  
  1856. USRH:x    - Whether  to (when conducting an INTERNAL purge) load all of
  1857.             the  users  in  memory to keep  conference  users  messages
  1858.             around   as specified by the various  DAYSTO???  parameters
  1859.             (in the MSGTOSS.CFG file.  Also setting to FALSE ("0") will
  1860.             make  the  internal purge as fast as  possible.   For  very
  1861.             LARGE  USERS files (like the main message base) will  speed
  1862.             up purging.
  1863.  
  1864.             Example:
  1865.  
  1866.             -USRH:0
  1867.             C:\RBBS\MAINM.DEF      NETMAIL
  1868.  
  1869.             -USRH:1
  1870.             C:\RBBS\RBBSM.DEF      RBBS-PC       1:343/300
  1871.  
  1872.             In  the  above  example,  the Main message base is  set  to
  1873.             USRH:0,  as  there  is alot of users,  and set the  smaller
  1874.             conference RBBS-PC to USRH:1.
  1875.  
  1876.             For   small   conferences  (who  have  small  user   files)
  1877.             recommended to be set for TRUE ("1").
  1878.  
  1879.             The  BBS keyword "USRH:1"   directs MSGTOSS whether to load
  1880.             all  of the  users into memory prior to purging.   For very
  1881.             large message bases with alot of users,   the purging speed
  1882.             can  be  dramatically increased by using  the  "USR:0"  BBS
  1883.             keyword,  as  hashing users will not take place.   However,
  1884.             loading the users have alot of benefits (read on).
  1885.  
  1886.             MSGTOSS  will  purge  ONLY ENOUGH messages  for  successful
  1887.             importation.  Therefore,  if only 2-3 messages are received
  1888.             in  a particular  conference,  then roughly the same amount
  1889.             will be purged (if there isn't enough space to begin with).
  1890.  
  1891.             MSGTOSS  can  handle  roughly 1500 users in memory  at  any
  1892.             one   time.  If  MSGTOSS detects that it is running out  of
  1893.             memory as users are being  loaded,   it  will  stop loading
  1894.             in  memory  and  page the remaining users  to  disk.   This
  1895.             causes  the purging to be slower (but more  complete).  For
  1896.             optimum operation, try to keep the sizes of your conference
  1897.             users  under  1500  or  use the USRH:0  BBS  keyword  where
  1898.             appropriate.
  1899.  
  1900.             Using  the  "USRH:1"   BBS  keyword will  prevent  messages
  1901.             from  being  purged before  the sysop or  conference  users
  1902.             have  had  a chance to read them.   This feature is  called
  1903.             "smart-purging" in other MSGTOSS documents.
  1904.  
  1905. -----------------------------------------------------------------------
  1906.  
  1907.  
  1908.  
  1909.  
  1910.                                   Page - 29
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.                          MSGTOSS.BBS Reference Manual
  1917.  
  1918.  
  1919. Capture messages with special text  -  CAPT:x
  1920. ---------------------------------------------
  1921.  
  1922. CAPT:x    - Whether  to (when tossing) to divert messages that  contain
  1923.             the "text words" as specified by the various "CAPTURE---->"
  1924.             items     entered in the MSGTOSS.CFG file.   These messages
  1925.             will  be  tossed   to a special area  called  "MSGCAPTURE",
  1926.             which  must exist in the MSGTOSS.BBS file.  Recommended  if
  1927.             used  to be a FIDO style area,  so after censorship can  be
  1928.             imported.
  1929.  
  1930.             Whenever  a message contains these words (could be anywhere
  1931.             in  the message) then MSGTOSS will divert those messages to
  1932.             a  special  area  defined as  MSGCAPTURE.    This  must  be
  1933.             entered in your MSGTOSS.BBS file as a non-echo'ed  area...
  1934.  
  1935.             Example: (in MSGTOSS.BBS)
  1936.  
  1937.             -CAPT:1
  1938.             C:\RBBS\RBBSM.DEF  RBBS-PC  1:343/300
  1939.             -CAPT:0
  1940.  
  1941.             C:\MAIL\CAPTURE.001    MSGCAPTURE       (non-echoed area)
  1942.  
  1943.             Example: (in MSGTOSS.CFG)
  1944.  
  1945.             CAPTURE----->SHIT
  1946.             CAPTURE----->FUCK  (We're all adults, right)
  1947.  
  1948.             These are entered in your MSGTOSS.CFG file.  Then  if  you
  1949.             have  "CAPT:1"  turned on for a particular conference  (in
  1950.             this example the RBBS-PC conference),  then those messages
  1951.             will  be diverted to C:\MAIL\CAPTURE.001 as  a  Fido-style
  1952.             message.   Note  that you will have to create  a  separate
  1953.             directory  for each unique Zone defined.   After  checking
  1954.             over these messages,  you can re-import these messages  to
  1955.             their   respective  conference  via  the   "/TCAP"   (toss
  1956.             captured) command line switch.
  1957.  
  1958.             ******************* WARNING WARNING **********************
  1959.             * Don't use this feature to censor other BBS systems!    *
  1960.             * This is intended to censor a private BBS system, for   *
  1961.             * those desiring this.  A safeguard was built in to      *
  1962.             * prevent those who /FEED downstream nodes from          *
  1963.             * capturing messages to downstream nodes.                *
  1964.             **********************************************************
  1965.  
  1966.             NOTE: To  use  this  feature,  you must turn  the  "CAPT:1"
  1967.                   switch on (in your MSGTOSS.BBS file).
  1968.  
  1969.             NOTE: After  you are done with the messages in  MSGCAPTURE,
  1970.                   you  can re-toss back to the proper area by using the
  1971.                   "/TCAP" (toss capture) switch.
  1972.  
  1973. -----------------------------------------------------------------------
  1974.  
  1975.  
  1976.                                   Page - 30
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.                          MSGTOSS.BBS Reference Manual
  1983.  
  1984.  
  1985. Enable Duplicate Checking for AREA - CDUP:x
  1986. -------------------------------------------
  1987.  
  1988. CDUP:x    - MSGTOSS  will check for duplicates during the tossing phase
  1989.             when using the CDUP:x keyword. If one is encountered,  wil-
  1990.             lignore  the  message and display in informational line  of
  1991.             the  duplicate  while tossing.   If you specified the /DLOG
  1992.             (Maintain  Dup  Log File) switch,  when a duplicate is  en-
  1993.             countered MSGTOSS will append  the date,  pkt,  msg number,
  1994.             area  and net/node of originating system into a file called
  1995.             MSGTOSS.DUP.
  1996.  
  1997.             This  feature allows individual conference configuration on
  1998.             whether  to check for duplicates (or not).   For  instance,
  1999.             you are having problems in the SCIENCE echo, but all others
  2000.             seem fine.  All you need to do is the following:
  2001.  
  2002.             -CDUP:1
  2003.             C:\RBBS\SCIENCEM.DEF  SCIENCE  1:343/300
  2004.             -CDUP:0
  2005.  
  2006.             All  other  echos  (following SCIENCE) will  have  the  dup
  2007.             checking disabled.
  2008.  
  2009.             NOTE: The  areas  NETMAIL,  UNKNOWN, ROUTETHRU & MSGCAPTURE
  2010.                   are exempt from dup checking.
  2011.  
  2012.             NOTE: If you have a reliable HUB, who faithfully checks for
  2013.                   DUPS before sending to you, then the use of this key-
  2014.                   word  may NOT be necessary and will make mail  events
  2015.                   as fast as possible.
  2016.  
  2017.             See MSGCFG.DOC (DUPFILE,  MAXAREAS, DUPSIZE),  MSGTOSS.DOC,
  2018.             (Duplicate messages) and MSGEID.EXE for more information on
  2019.             this.
  2020.  
  2021. -----------------------------------------------------------------------
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.                                   Page - 31
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.                          MSGTOSS.BBS Reference Manual
  2049.  
  2050.  
  2051. Set Mailwaiting Bits for new RBBS msgs MWST:x
  2052. ---------------------------------------------
  2053.  
  2054. MWST:x    - Use  MSGTOSS's internal code to set mailwaiting bits in its
  2055.             associated user file for all new messages.  After  success-
  2056.             ful  tossing of the messages,  MSGTOSS will set the  'mail-
  2057.             waiting bits' for the active conference.  This allows users
  2058.             to  be  notified when they log-on the system  whether  they
  2059.             have mail waiting  to be read in  each of the  conferences.
  2060.             During   initializing,   MSGTOSS  will remember  what   the
  2061.             first  message was  before  it  started tossing,  therefore
  2062.             if  you use the MWST:1 keyword,  it will ONLY set the   bit
  2063.             for new messages.
  2064.  
  2065.             NOTE: When using the /MWRST (mailwaiting reset) switch, all
  2066.                   MWST:x keywords are ignored.
  2067.  
  2068. -----------------------------------------------------------------------
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.                                   Page - 32
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.                          MSGTOSS.BBS Reference Manual
  2115.  
  2116.  
  2117. Maintain a history file of purged msgs HIST:x
  2118. ---------------------------------------------
  2119.  
  2120. HIST:x    - If  HIST:x  is true (HIST:1) then MSGTOSS will  append  all
  2121.             purged  messages  into a *.HIS file.   The message will  be
  2122.             off-loaded in text format, similar to RBBS-PCs internal ed-
  2123.             itor.   If the message base is RBBSM.DEF,  MSGTOSS will ap-
  2124.             pend all purged messages into a file called RBBSM.HIS.  For
  2125.             the file MESSAGES, will be MESSAGES.HIS.  It is recommended
  2126.             that this feature be used in moderation.  Overuse may cause
  2127.             disk space to be filled up fast!
  2128.  
  2129.             Example:
  2130.  
  2131.             -HIST:1
  2132.             C:\RBBS\RBBSM.DEF   RBBS-PC
  2133.             -HIST:0
  2134.  
  2135.             Will  create/append all purged messages into a file called
  2136.             RBBSM.HIS.  Here is an example of the text format.
  2137.  
  2138. ---------------------------------------------------------------------------
  2139. Msg #: 23                      Purged: 01-15-92 18:58:00
  2140.  From: MIKE ZAKHAROFF            Sent: 12-29-91
  2141.    To: ALL                       Rcvd: <Not Rcvd>
  2142.    Re: MSGTOSS 2.0
  2143.  
  2144. Will  be  releasing MSGTOSS 2.0 real soon.   Are you ready  for  "mail
  2145. tosser shock"?
  2146.  
  2147. Have a Happy New Year!!!
  2148.  
  2149.  
  2150. --- MsgToss 2.0
  2151.  * Origin: MsgToss Support System (206)555-1212 (1:138/154)
  2152. ---------------------------------------------------------------------------
  2153.  
  2154.             NOTE: This  does slow down purging,  as the message has to
  2155.                   be  exported  FIRST,  then the  pack-in-place  takes
  2156.                   place.
  2157.  
  2158. -----------------------------------------------------------------------
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.                                   Page - 33
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.                          MSGTOSS.BBS Reference Manual
  2181.  
  2182.  
  2183. Zone/Domain gating option  -  GATE:x
  2184. ------------------------------------
  2185.  
  2186. GATE:x    - Whether  to enforce normal echo mail rules when  generating
  2187.             echo  mail control lines within messages.   GATE:2 performs
  2188.             normal  echo  mail  handling,  providing  zone  and  domain
  2189.             separation   of  echo areas.   Only mail addressed to  your
  2190.             NODE   addresses  in  the  same  zone  and  domain  as  the
  2191.             identified with the NODE:x key word will be tossed into the
  2192.             area.   Seen-by  lines will list only your AKAs that  match
  2193.             the  zone and domain of the receiving system.   This is the
  2194.             normal mode for all backbone echo mail conferences.  GATE:1
  2195.             relaxes  these  rules to allow you to DELIBERATELY  VIOLATE
  2196.             ECHO  MAIL RULES and freely share selected echos that  have
  2197.             LIMITED  distribution  and do not depend on the  echo  mail
  2198.             control  lines to track their routing.   GATE:1 echos  will
  2199.             receive mail addressed to any of your AKAs and will add all
  2200.             of your AKAs,  regardless of zone and domain,to the seen-by
  2201.             lines sent to all recipients of the message.
  2202.  
  2203.             Example:
  2204.  
  2205.             -GATE:2
  2206.             C:\RBBS\RBBSM.DEF  RBBS-PC  1:343/300
  2207.  
  2208.             NOTE: Unless  you  are really familiar with all aspects  of
  2209.                   MSGTOSS,   and   how   it   behaves   in   multi-zone
  2210.                   environments,  its better to leave this set to GATE:2
  2211.                   all of the time.
  2212.  
  2213.             Beta Info:
  2214.  
  2215.             The    GATE:x   option   determines   if   an   echo   area
  2216.             may  be shared between domains and zones.   GATE:2  enables
  2217.             zone  and  domain  separation,  and works  very  much  like
  2218.             MsgToss  has  always done.   GATE:1 disables the  zone  and
  2219.             domain  isolation  that MsgToss does so  well.   GATE:1  is
  2220.             useful  for local (or non-backbone) echos that you wish  to
  2221.             share freely with all zones you support.  SEEN-BY lines for
  2222.             GATE:1  areas  will  contain node addresses for all  zones.
  2223.             Be  sure  to  use GATE:2 for backbone echos  to  keep  your
  2224.             seen-by  lines  clean.   (MsgToss  will default  to  GATE:2
  2225.             unless you intentionally tell it to shoot you in the foot.)
  2226.  
  2227. -----------------------------------------------------------------------
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                   Page - 34
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.                          MSGTOSS.BBS Reference Manual
  2247.  
  2248.  
  2249. Origin: line to be used for scanning  -  ORGN:text
  2250. --------------------------------------------------
  2251.  
  2252. ORGN:text - When exporting (scanning) a message,  what Origin:  line to
  2253.             use.  In addition, during a PURGE operation, and MSGTOSS is
  2254.             processing a previously exported message,  and "<XMT>"  was
  2255.             placed  during  a /SCAN operaion,  the Origin line  MSGTOSS
  2256.             will insert into the message while purging.
  2257.  
  2258.             Example:
  2259.  
  2260.             -ORGN:MSGTOSS is wonderful!
  2261.             C:\RBBS\RBBSM.DEF  RBBS-PC  1:343/300
  2262.  
  2263.             Will appear on the outbound message when exported as...
  2264.  
  2265.             * Origin: MSGTOSS is wonderful! (1:343/36)
  2266.  
  2267.             NOTE: The  ORGN:xxx entry(s) must be either the LAST  entry
  2268.                   of a series of BBS keywords --or-- on a line by own!
  2269.  
  2270.             The  default"  origin line (the one at the top of the file)
  2271.             will ALWAYS apply,  EXCEPT for the "first" message base af-
  2272.             ter the -ORGN:xxxx entry...
  2273.  
  2274.             Example:
  2275.  
  2276.             INTERSTATE BBS Sea WA (206)631-3231 450 Meg
  2277.  
  2278.             The default origin line
  2279.  
  2280.             -ORGN:MSGTOSS - The BEST for RBBS (Ver 2.0 coming soon)!
  2281.             C:\RBBS\rbbsm.def     RBBS-PC       343/300
  2282.  
  2283.             Default takes over again
  2284.  
  2285.             C:\RBBS\sciencem.def  SCIENCE       343/300
  2286.             C:\RBBS\techm.def     TECH          343/300
  2287.             C:\RBBS\warningm.def  WARNINGS      343/300
  2288.  
  2289. -----------------------------------------------------------------------
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                   Page - 35
  2307.  
  2308.  
  2309.  
  2310.  
  2311.